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SOFTWARE UNIT: 


ident. . Rev. Card Count 
REMIA (Macro Library) g 41 
REM1B (Macro Library) g 42 
REM1C (Macro Library) g 41 
TBP8 (Relocatable) g 8 
G?XX (Relocatable) g 11 


REASON FOR RELEASE: 


1. 


To correct the following problems in REMI: 


a. A "READY" (X'@5') keyin would be ignored after a special forms 
message from the 1108. 

b. It was difficult or impossible to execute subsequent programs oa 
without rebooting the Operating System after running REMI. ; 

c. REM1 was incapable of operating the printer at more than half 

. of rated print speed, regardless of modem speed or print line size. 

d. Certain characters in the card input to REM1 were erroneously 

translated as EOM characters, leading to unrecoverable errors, 


To implement the following enhancements to REMI: 


a. It is now possible to generate and assemble REM1 on an 8-K machine 8 
(standard reader plus either serial or row punch). ; 
b.. It is now possible to specify that card image input or output will 
be accomplished by means of user-—supplied routines, thus permitting 
input/output of tape, disc, paper tape, or other kinds of files, 
c. Issuance of CNTRL macros to achieve maximum possible punch speed if 
card output is to the serial punch. 


SOFTWARE RESTRICTIONS: 





None. 


HARDWARE CONFIGURATION: [ 


OF WD 
eeoeeee 


9200/9300 with 8-K memory. 
Card Reader. 

Serial Punch or Row Punch. 
Bar Printer. 

Dpes-1 or DCS-4. 


SPECIAL NOTES: 


1. 


Since the majority of REM1 users operate 8-K card system terminals, 
the REM1 macro library was broken into three smaller macro libraries 
so as to facilitate generation on the same machine as REM1 will be 
operated upon. To generate the REM1 source deck, it is necessary to 
operate the Macro Generator once with each library (REM1A, REM1B, and 
REMIC). The macro calls REMIA, REM1B, REMIC, are used with the 
respective libraries along with the same keyword parameters and 
specifications for each call as were formerly used in generating REMI1 
{see 3 to 5 below for new parameters!., The label which is punched in 
the REM1A macro call card is generated into the START line to permit 
distinguishing between different versions of the REM1 main program. 
The END card which is punched by each of the first two preassembly 
macro passes must be discarded; the END card for REMIC must read 

"END G2?Z"; the source decks punched by the macro generator must be 
submitted to the Assembler in REMIA - B ~ C order. If assembly is 
done on an 8-K machine, a "CTL ,8191" statement must precede the 
REMI source deck in the Assembler's input. See Appendix A for 
diagram of generation procedures. 
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The EBCDIC-to-compressed translate table, TBP8, has been made a separate 
relocatable element. It must be included in the linker run which pro- 
duces the loadable REM1 object deck whenever OUT=OWNCD is not specified 
and/or IN=OWNCD is specified. The compressed—to-XS3 translate table, 
G?CX, and the XS3-to-EBCDIC translate table, G?XE, have been combined 
into a separate relocatable element, G?XX. It must always be included 
in the input to the linker when producing a loadable REMI. 


The unnecessary keyword parameter "DEVA" has been deleted. REM1 does 
not, and has never, inspected or altered logical/physical unit tables. 


Two new parameters may be specified, "IN" and "OUT". Possible speci- 
fications are as follows: 


a. IN=OWNCD, if the programmer provides his own routine to replace the 
normal card input routine. 

b. OUT=OWNCD, if the programmer provides his own routine to replace 
the normal card output routine. 

c. OUT=SERP, if card output is to the serial punch. The serial punch 
I0CS which is generated for linkage to REM] must include the 
specification CNTL=YES if OUT=SERP is specified, since REMI] will 
issue CNTRL macros to the punch IOCS to limit the number of 
columns punched. 


If the operating system under whose control REM1 is to be executed is 
of NCOS or higher level, SYST=TAPE must be specified, regardless of 
whether that system is tape- or disc-resident. 


If IN=OWNCD is specified, REM1 will assume that its input will be in 
EBCDIC and will consist of images that would make up a normal 1108 

run deck. The input file must be assigned the label G?CI; REM1 issues 
3 macro instructions to this file, OPEN, GET, and CLOSE. If the 
complexity of the input data is such that REM1 should not attempt to 
reference the actual input file directly, the programmer should be 
aware that the assembler generates the following calling sequences 

for the various macro instructions: 


OPEN BAL 14,filename 
CLOSE BAL 14,filename+4 
GET BAL 14,filename+8 
DC Y(workarea address) 
PUT BAL 14,filename+16 
DC Y(workarea address) 


If the user programmer wished to cause the reading of 100-byte tape 
records for transmission to the 1108, the following "OWNCD" input 
routine would probably suffice: 


INPT START @ 
TPIN DIFMT DEVA=2,BKSZ=49%,RCSZ=1@%,WORK=YES, etc., etc. 
HDLR DMTIO WORK=YES, etc., etc. 
ENTRY G?CI 
G?CI BC 15,OPEN 
BC 15,CLOS 
GET BC @,PAR2 BC 15 IF 2ND HALF OF RECORD 
STH 14,GETX+2 SAVE RETURN 
GET TPIN,W18¢ READ TAPE RECORD 
CLI W19g,Cc'@! 1188 CONTROL CARD ? 
BC 8, *+8 SKIP NEXT LINE IF SO 
MVI GET+1,X'FQ' SET PART-TWO SWITCH 
LH 14,GETX+2 
LH 15,8(,14) LOCATE REM1'S WORKAREA 
MVC (88,15) ,W1ig¢ MOVE 1ST 8% BYTES OF TAPE RECORD 
AI GETX+2,2 ADJUST RETURN 
GETX BC 15,6 RETURN 
PAR2 MVI GET+1,@ RESET PART-2 SWITCH 
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LH 15,6(,14) FIND REM1 WORKAREA 
MVC = (29,15) ,W1@@+88 | MOVE REMAINDER OF TAPE RECORD 


MVI 20(15),c' ! BLANK-FILL REST 
MVC 21(59,15) ,28(15) OF REM1 WORKAREA 
BC 15,2(,14) RETURN 

OPEN STH 14, *+19 
OPEN TPIN OPEN TAPE FILE 
BC 15,8 

CLOS STH 14, *+1¢ 
CLOSE TPIN CLOSE TAPE FILE 
BC 15,2 

W12d DS CL19¢ TAPE WORKAREA 
END 


If an actual 1108 run deck is being read from tape, REM1 will never 
cause the tape IOCS' EOFA routine to be entered. A halt or error 
recovery routine could be placed at the label which is assigned to 
the EOFA parameter. The OWNCD routine must store and reload any 
registers other than 14 and 15 which it uses. 


7. j%|.[£ OUT=OWNCD is specified, REM1 will assume that its output will be 
in EBCDIC and will deliver those images which are transmitted to it. 
by the 1108 for punching. The output file must be assigned the label 
G?CO; REM] issues 3 macro instructions to the output file, OPEN, PUT, 
and CLOSE. See the input own-code example above for typical coding 
where the complexity of the data being transferred does not permit 
REM1 to reference the actual I/O routine. NOTE - if the only deviation 
from normal card output is to be translation to other card codes, this 
may be accomplished by substituting the desired EBCDIC-to-compressed 
translate table for TBP8 and by equating "TBP8" to the name of the 
user-supplied table in the linker run. 


8. When REM] is executed, it does not open its reader file until such time 
as a "READY" (X'@5') keyin is made. When a "READ CARDS" (X'@6') keyin 
is made, it ignores all card input until a card with "@RUN" in columns 
1-4 is encounteréd;- this is the first card to be transmitted to the 
1108. Then, when a card with "@@" in columns 1-2 is read, it stops 
reading cards. If no cards are to be transmitted to the 1108, suf- 
ficient cards must be in the reader so as to prevent a hopper-empty 
halt; under NCOS, a "DATA C" card, followed by "/*", followed by valid 
control stream cards must be present. 


9. REM1 does not go to its End-of-Job routine until an "OFFLINE" (X'@C') 
keyin is made. Its execution must be terminated by this keyin to 
insure proper closing of all files. The unnecessary X'66@6' halt 
has been eliminated; under MOS, REM1 will cause the Supervisor's 
X'41EF' halt to occur upon normal completion; under NCOS, Job Control 
will be loaded and the remainder of the 9300 Control Stream will be 
processed. 


10. A new REM1 macro library and the TBP8 and G?XX relocatables will be 
included in the next tape and 8411/8414 disc software updates. REM1 
will continue to be distributed as a single macro to recipiénts of 
tape and disc software. 


ORDERING PROCEDURES: 


The REM1 software package described herein is available upon request in 
card format. It may be ordered by forwarding the attached "Software 
System Support Request" directly to Software Order Services. 


Sperry UNIVAC 9200/9300 Software Coordinator 
Sperry UNIVAC — Software Order Services 

P. O. Box 500 

Jolly Road & Township Line Road 

Blue Bell, Pennsylvania 19422 
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Note: Ail users outside the United States should check with their local 
UNIVAC subsidiary office for distribution procedures. The above 
applies to United States customers only. : 


DESTRUCTION: 
This memo supersedes and orders the destruction of 9300 Release Memo #83 4 


dated January 8, 1971, as well as the former REM1 Macro Library (Rev. 5) 
distributed with that memo. 
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2. Assembler. 


3. tULinker. 
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** CHECK BOX FOR SOFTWARE REQUIRED, 





ane SIGNATURE APPROVED ~ 
USER D.P. MGR/LOCAL S.A. MGR. 








PECIAL INSTRUCTIONS; 4 
SEE ORDERING PROCEDURES PAGE 3 of 4, } 


REMARKS AND/OR ADDRESS CORRECTION SEND REQUEST FORM _TO; | 


SPERRY UNIVAC : 
SOFTWARE ORDER SERVICES | 
TOWNSHIP LINE AND JOLLY RD. | 
BLUE BELL, PA, 19422 : 








ae, NOTE; ALL USERS OUTSIDE THE UNITED STATES SHOULD CHECK WITH THEIR 
. LOCAL UNIVAC SUBSIDIARY OFFICE FOR DISTRIBUTION PROCEDURES. 
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